12.1 Obtain payment exchange rate (system real-time)

#Brief description: Get payment exchange rate interface (system real-time)

• Request method: POST
• Request interface: https://gateway-domain/wallet-trade-merchant/v1/utils/rate/payment
• Request media type (JSON data format)Content-Type: application/json

Query parameters

Parameter name	Type	Required	Parameter meaning	Parameter description
key	string	Yes	Merchant key	apiKey
currency	string	Yes	Currency (order currency)	Example: CNY
userCurrency	string	Yes	User’s actual received currency	Example: USDT
sign	string	Yes	md5 signature	For details, see Signature Algorithm (Document 2)

Request json sample

{
 "key": "9yUreYgTRtit39Dy",
 "currency": "CNY",
 "userCurrency": "USDT",
 "sign":"dbc72adf640a82e0b21f98c50afb2881"
}

Return value

Parameter name	Type	Parameter meaning	Parameter description
code	int	Request status	Communication status Successful return: 0, others indicate failure
success	boolean	Success Status	true Success
message	string	Description
data	json	Parameters	Please refer to the following description for parameters

Return to Example

{  
    "code": 0,  
    "success": true,  
    "message": null,  
    "data": {  
       "baseCurrency": "USDT",
       "quoteCurrency": "CNY",
       "tradePair": "USDT/CNY",
       "rate": 7.10324538,
       "costRate": 0.14078072015020265,
       "costReverseRate": 7.10324538,
       "exchangeAction": "BUY",
       "quoteExpression": "1USDT≈7.1032CNY",
       "baseAmount": "14.078072",
       "quoteAmount": "100"
    }  
}

data parameter description

Parameter name	Type	Parameter meaning	Parameter description
baseCurrency	string	Base Currency
quoteCurrency	string	Quote Currency
tradePair	string	Trading Pair
rate	string	Price
costRate	number	Calculate price ( FROM x rate = TO )
costReverseRate	number	Calculate the price in reverse (TO x rate = FROM )
exchangeAction	enum	Transaction Type	BUY:Buy| SELL: Sell
quoteExpression	string	Exchange rate expression	Expression in quotation form
baseAmount	string	Base Amount	Example Base Amount
quoteAmount	string	Quotation amount	Sample quotation amount